home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 February / Macworld (1998-02).dmg / Shareware World / Utilities / Disk & File / Icon Machine 68k / ReadMe < prev    next >
Text File  |  1997-11-08  |  13KB  |  142 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14. The Introduction
  15.  
  16. What is Icon Machine?
  17.    Icon Machine is an icon editor- it lets you customize the icons of items in the Finder. To edit the icon of an item, just drag it onto the Icon Machine icon in the Finder, and Icon Machine will open a window in which you can edit the icon. When you’re done, use the Save command to apply your new icon. And there you are.
  18.    Also, Icon Machine is shareware. A paltry 20 bucks. If you decide you like the program and want to continue to use it, please pay for it as described at the end of this file. If you don’t think it’s worth $20, just delete it from your hard disk and wait around for the next version.
  19.    And what do you get for that $20, besides freedom from a guilty conscience? Why, my undying gratitude, of course! I will do my best to support all registered Icon Machine users by helping them with questions, notifying them of new versions of the program, and taking their complaints an bug reports much more seriously.
  20.  
  21. Why is Icon Machine?
  22.    When I first started using System 7 and saw how you could customize icons by pasting them in the Finder’s Get Info windows, I immediately said, “Hey, what we need is an icon editor!” And the idea of Icon Machine was born, and has been evolving ever since. Other people have made icon editors too, and I have tried out as many as I could get my hands on (because if I found one I liked enough it would save me a lot of trouble!) but I was never quite satisfied. If you want a thing done right....
  23.  
  24. How is Icon Machine?
  25.    Well, I think it’s pretty cool. I tried to make it as useful and usable as possible, and as a part of that I have included extensive support for Macintosh Drag and Drop. A lot of ideas have come and gone, many of which are reserved for upcoming versions of this program. If you have any comments or suggestions, I would be overjoyed to hear them. Really.
  26.  
  27. Editing Icons
  28.  
  29. Tools
  30.    Icon Machine has a pretty much standard array of painting tools: lasso, marquee, pencil, paint bucket, line, rectangle, oval, line, polygon, and text. The usual rules for each tool apply- use the shift key to constrain them, etc.
  31.    When using the text tool, the arrow keys don't move the insertion point; instead, they move all of the text by one pixel.
  32.    Various special things have been added to the tools for working with masks. What's a mask? I'm glad you asked.
  33.  
  34. Masks
  35.    The icon mask is sort of a black-and-white picture which defines which parts of the icon are transparent and which are opaque. Each icon family can have two masks- one for the large size, one for small. Technically, these masks are stored with the black-and-white members of the family, so if these members are missing then there is no mask. Also, if those members are missing then the Finder won’t use that size.
  36.    The mask is automatically updated as you edit the icon, and some tools let you edit the mask directly. More on this later.
  37.  
  38. Selections
  39.    If you hold down the option key while dragging a selection, it will leave a copy behind. If you hold down command and option, it will leave a trail. The shift key constrains dragging to horizontal and vertical movement (but you have to hold it down after pressing the mouse button).
  40.    Through the magic of Macintosh Drag and Drop, you can also drag a selection outside of the window, either to another editing window or to another application (like the Finder, to create a clipping file).
  41.    You can also use the shift key with the lasso and marquee tools to add to the selection, and the command key will subtract from the selection. It’s fun. Note, though, that you’re using the same keys as for making copies and constraining, as described above. The trick is this: if you want to modify the selection, hold down the keys before clicking the mouse; to make copies or constrain movement, hold them down after pressing the mouse.
  42.    The lasso has an additional behavior: if you hold down the option key as you press the mouse, it behaves like a "magic wand" - it selects all adjacent pixels of the same color. It works like the paint bucket (for filling), only instead of painting, it selects. A handy trick with this is if you have a white area that you want to make transparent, you can select it with the "magic wand", and then delete the selection.
  43.  
  44.   
  45.  
  46. Colors and Patterns
  47.    The middle toolbox lets you select colors (using the pop-up menu or the dropper tool) and patterns. The F box is the foreground color, the B box is the background color, and the P box is the pattern. You can also use the dropper to pick up any color you click on—a normal click sets the foreground color, and a shift-click sets the background color. If you are using one of the other drawing tools, you can quickly access the dropper by holding down the option key.
  48.    The foreground color is used for the pencil, bucket, line, text, the outlines of the shapes, and the “black” parts of a pattern. The background color is used for the “white” parts of a pattern, and also as the background color when erasing, either with the eraser or the pencil. If you select something and move it (without holding down the option key), the opaque areas will be replaced by the background color. This can be useful when you want an image that doesn’t have a white background, like the light gray inside the document icon.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.    When editing the 8-bit (256-color) icons (the first and third ones as displayed in the member selector), there are two color palettes you can choose from: the System palette (rearranged a little; shown above left), and the standard 35 icon colors (the colors you are recommended to use in Finder icons; shown above right). To switch between these, select the palette you want from the Colors menu.
  61.    The reason to use the standard icon colors is that they are the only ones that will darken properly when an icon is selected, or that will tint properly when an item is assigned a Label color in the Finder.
  62.    As you drag the mouse across the System palette, you will sometimes see other color boxes hiliting. This is because some colors were duplicated to complete the layout; when two boxes are hilited, it's because they contain the same color.
  63.  
  64.  
  65. Drawing Mode
  66.    The next toolbox lets you choose between opaque and transparent drawing. When the mode is set to transparent, the shape tools will only draw an outline. When it’s set to opaque, shapes will be filled with the selected pattern.
  67.  
  68. Mask Mode 
  69.    The final three-button toolbox is for switching between the three mask editing modes. The first is for normal mode, where tools may affect both the icon image and the mask. The second is mask mode, where the image is not affected, and the third is image mode, where the mask is not affected.
  70.    For example: if you start off with an empty icon, and draw a line in normal mode with the pencil, you get a black line. In mask mode, you get a white line (against the field of dots that show transparency). In image mode, you get a black line, but only in the parts that are already opaque (like the line you made with the mask pencil).
  71.    The cursor, if possible (depending on its shape), will show the current mode: a regular cursor for normal mode, a solid black cursor for mask mode, and a transparent cursor for image mode.
  72.    You can also override the setting in the palette using the keyboard: Hold down the command key for mask mode; hold down the command and option keys for image mode.
  73.  
  74. Preview
  75.    Underneath all the toolboxes are the preview, and the selector to choose what mode you want to preview the icon in: selected, open, or offline (like on an ejected disk). You can select any combination of these, or select Normal to clear them all.
  76.  
  77. Member Selector
  78.    To the right of the painting area is the member selector, for choosing which member of the icon family you want to edit. You can also drag the icons from these buttons, as well as drop icons into them. This is handy for copying data from one member of the family to another.
  79.    The members you can select are, from top to bottom: large 8-bit (256 colors), large 4-bit (16 colors), large 1-bit (black-and-white), small 8-bit, small 4-bit, and small 1-bit. An empty, inset box on one of these buttons means that member doesn't exist in the icon family. To create it, just click on that member. To delete an existing member, use the Delete Member command in the Edit menu.
  80.  
  81. Name and Original Icon
  82.    At the bottom of the window are the name of the item you’re editing, and it’s orignal (non-custom) icon. The name dispayed is the full path name of the item, like “Hard Disk:Thingies:Grizzly Bears”. If it's too long, it will be truncated by taking out the names of some of the folders.
  83.  
  84. Icon Machine's Funny Little Things That It Does
  85.    Icon Machine has some limitations and rules that it enforces to make sure that your icons will work in the Finder. They might get in the way a little, but they seemed like a good idea at the time.
  86. • You can’t erase the mask in places where other members of the same size have non-white pixels. Remember that all members of the same size share the same mask. If you have a stubborn spot of mask that won’t erase, switch to the other members and make sure they’re white in that spot as well.
  87. • You can delete members of an icon family, but you cannot delete the large black-and-white member. If this one is missing, then the Finder will ignore the entire custom icon, so what's the point? Similarly, if you have one of the small color members you must also have the black-and-white one. Remember that the mask is stored with the black-and-white members, so they need to be kept around even if the black-and-white icon itself is empty.
  88. • The eraser (in normal mode) will not erase the mask if the background color is something other than white. After all, you’re really just painting in this case. If you're wishing Icon Machine had a paintbrush, try just erasing with the color you wanted to paint with.
  89.  
  90. The “Edit Icon” Contextual Menu Plugin
  91.  
  92.    In the PowerPC version of the Icon Machine package, you will notice a file called "Edit Icon". If you have Mac OS 8 or later, you can place this file in the Contextual Menu Items folder in your System Folder. This plugin will add a command called "Edit Icon" to the contextual menu of any file, folder, or disk which will open the item's icon in Icon Machine. If you don't have Mac OS 8, what are you waiting for?
  93.    A contextual menu, by the way, is the one that appears when you hold down the control key and click on something. But only in Mac OS 8.
  94.  
  95. Drag-and-Drop Summary
  96.  
  97. Currently the editing area and the member selector support drag and drop; other parts of the Icon Machine window will be joining them soon.
  98.  
  99. Dragging
  100. - Drag selections from the paint area
  101. - Drag members of the icon family from the member selector
  102.  
  103. Dropping
  104. - Drop icons and pictures onto the painting area
  105. - Drop icons onto buttons in the member selector to replace them
  106.  
  107. The Future of Icon Machine
  108.  
  109. Icon Libraries and the File Window
  110.    This feature has always been a part of Icon Machine's design, although it was omitted from this initial version because I was getting impatient to get this thing out the door. Icon Machine will be able to store multiple icon families in library files, as well as open other files (like applications) that have icons stored in them.
  111.  
  112. Tear-Off Palettes
  113.    The color and pattern palettes will be able to be torn off into floating windows.
  114.  
  115. Et Cetera
  116.    Contextual menus, new drawing tools, Appearance Manager support, and a rearranged window are also among the other things on the drawing board. Brace yourselves!
  117.  
  118. Money
  119.  
  120.    As mentioned at the beginning, Icon Machine is shareware. Try before you buy; just don't forget to buy! You can register your copy for $20 through Kagi Shareware. The option of a site license is also offered; this allows you to use as many copies as you need at a particular site. If your company only has one site, that's all you need! A site license is $100.
  121.    Using the enclosed Register program, fill out your name, how many copies you're registering, and your payment method. Then you can print the from and mail it, fax the form, or copy and e-mail it. The addresses you need will be given in the form itself.
  122.    Alternately, you can register on the Web at the following address:
  123.    http://order.kagi.com/?2YD
  124.  
  125. Version History
  126.  
  127. 1.0.1
  128. - Updated to PowerPlant 1.8. The most visible result of this is that the Other Size dialog looks a little different.
  129. - Fixed a crash in the polygon tool.
  130. - Fixed a problem with the pencil's auto-erase in 16-color icons.
  131. - Corrected a typo in the balloon help
  132.  
  133. That's the End
  134.  
  135.    If you have more questions, you might try the Apple Guide file. Also, you can find the latest info at the Icon Machine web page:
  136.    http://www.kagi.com/dathorc/iconmachine.html
  137.    You can also e-mail me at dathorc@kagi.com.
  138.    When all else fails, you can try the old-fashioned method:
  139.      David Catmull
  140.      2255 Hearst St. #29
  141.      Berkeley CA 94709
  142.